home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 076-100 / disk_087 / dropshadow / readme < prev    next >
Text File  |  1992-05-06  |  4KB  |  101 lines
  1.  
  2.     DropShadow                     Copyright James Mackraz, 1987
  3.     Version 2, Revision 0                        April 7, 1987
  4.  
  5.     -----    -----------------------------------------   -----
  6.     Notes for source release                    May 2, 1987
  7.  
  8.     This program and all or any part of the source cannot be
  9.     distributed for profit.  Inclusion on not-for-profit disk
  10.     collections is permitted.  The program may not be modified
  11.     to omit or modify the title in the control window.
  12.  
  13.     Notice that this program still has holes from the early
  14.     versions. For one thing, it assues that layers activity
  15.     always happens on the workbench, and will recalculate
  16.     the shadow.  Another, is that it doesn't take any care to
  17.     be sure that no other program has pre-empted the layer vectors
  18.     that it steals.  So in the words of Sidekick: load me last.
  19.  
  20.     Also, the option to make the shadows move with the hour
  21.     and the season (after you configure virtual north) has
  22.     not been implemented.
  23.     -----    -----------------------------------------   -----
  24.     Notes for Version 2, Revision 0             April 7, 1987
  25.  
  26.     Added the following from the wish list:
  27.  
  28.     -A slider gadget is implemented to adjust the 3-dimensional
  29.     distance between the planes of the windows.
  30.  
  31.     -A slider gadget is implemented to adjust shadow darkness.  If
  32.     desired, full independent control of the shadow colors is
  33.     possible.
  34.  
  35.     I had some problems with the latter, so I now increase the
  36.     task priority while the darkness slider is selected.  It
  37.     has not been tested thoroughly. (May 2: haven't heard any
  38.     complaints yet.)
  39.  
  40.     -----    -----------------------------------------   -----
  41.     Notes for Version 1, Revision 1                March 12,1987
  42.  
  43.     When Windows are moved, created, sized, deleted, or depth-
  44.     arranged, Intuition calls layers.library.  This program
  45.     intercepts those calls to determine that the shadow needs
  46.     to be recalculated.  Before this version, this recalculating
  47.     and redrawing was done before Intuition got a chance to
  48.     redraw Window borders and Gadgets.
  49.  
  50.     This version of DropShadow performs the work on its schedule,
  51.     and is only signaled by the code which intercepts the
  52.     layers calls.  This makes for a smoother and less dangerous
  53.     implementation.
  54.     -----    -----------------------------------------   -----
  55.     Notes for Version 1, Revision 0                March 1, 1987
  56.  
  57.  
  58.     The program on this disk creates and maintains multi-level
  59.     transparent drop shadows of windows on the Workbench screen.
  60.  
  61.     The program creates its own window, and is terminated by closing
  62.     that window.  The program, named DropShadow, may be run from
  63.     the CLI, or if associated with an icon, from the Workbench.
  64.  
  65.     The shadows are created by attaching an additional bitplane to
  66.     the Workbench's display bit map, but doing so in a way which
  67.     is transparent to the Workbench or its application programs.
  68.  
  69.     Unfortunately, this third bitplane brings the Workbench screen
  70.     to a point which causes processor cycles to be stolen by the
  71.     display generation hardware.  Thus, this program is probably
  72.     best used only for demos and having fun, at least for users
  73.     without "Fast" RAM.
  74.  
  75.     Enhancements which are planned include:
  76.  
  77.     -The program detects that the shadow image needs to be
  78.     recalculated by monitoring the layers library.  That section
  79.     of code should check that the layers activity is in fact in
  80.     the Workbench screen.
  81.  
  82.     -A way to detect color changes in preferences would allow the
  83.     shadow colors to track user changes to the Workbench colors.
  84.     In the meantime, the program must be restarted to initialize the
  85.     shadow colors.  Commodities Exchange can be used for this.
  86.  
  87.     -A technique of unknown type is planned for user control of
  88.     the light source which casts shadows.  Shadows cast according
  89.     to the position of the sun (time of day and season) are possible
  90.     but unlikely.
  91.  
  92.     -This program is not yet a safe Library vector stealer.  It should
  93.     refuse to exit if some other program has displaced its vectors,
  94.     lest that other program call DropShadow after it has exited.
  95.  
  96.  
  97.                                 Jim Mackraz
  98.                                 4021 Second St.
  99.                                 Palo Alto, CA 94306
  100.  
  101.